Skip to main content

Apps

Create and manage applications within your sites to build custom functionality.

Overview​

Apps are the core building blocks of your Taruvi site. Each app contains functions, policies, roles, storage, and database tables. Apps provide a logical grouping for related features and allow you to organize your backend services.

Concepts​

App​

An application within a site that contains business logic, data models, and API endpoints. Apps provide isolated namespaces for functions, policies, and storage.

App Type​

Apps can be classified as "custom" (user-created) or "builtin" (system-provided). Most apps you create will be custom apps.

App Slug​

A URL-friendly identifier for your app, automatically generated from the app name. Used in API endpoints and navigation.

Create an App​

Create a new app to start building your application functionality.

  1. Navigate to your Site in the Dashboard.
  2. Click the Apps tab.
  3. Click Create New App.
  4. Fill in the app details:
    • App Name: A descriptive name for your app (required)
    • Description: Optional description of the app's purpose
  5. Click Create App.
tip

Choose a clear, descriptive name that reflects your app's purpose. The name will be used to generate API endpoints and URLs.

View Apps​

  1. Navigate to your Site in the Dashboard.
  2. Click the Apps tab.
  3. The apps list displays:
    • App Name: The display name
    • URL: The app's endpoint URL (if configured)
    • Created Date: When the app was created

Search Apps​

Use the search bar to filter apps by name:

  1. Enter your search term in the Search apps by name... field.
  2. Results update automatically as you type.

Pagination​

Navigate through large lists of apps using:

  • Page navigation: Click page numbers at the bottom
  • Page size: Change the number of items per page

Open an App​

  1. Navigate to your Site in the Dashboard.
  2. Click the Apps tab.
  3. Click the Open button on the app card.
  4. You'll be taken to the app dashboard with access to:
    • Functions
    • Events
    • Policies
    • Roles
    • Storage
    • Database Editor
    • Analytics
    • Settings

Edit an App​

  1. Navigate to your Site in the Dashboard.
  2. Click the Apps tab.
  3. Click the Edit (pencil) icon on the app card.
  4. Update the app details:
    • App Name: Change the display name
    • Description: Update the description
    • App URL: Set the public URL where your app is accessible
    • Editor URL: Set the URL for the app editor/admin interface
  5. Click Save Changes.

Import an App​

Import existing app configurations from a file.

  1. Navigate to your Site in the Dashboard.
  2. Click the Apps tab.
  3. Click the Import button in the header.
  4. Select your app configuration file.
  5. Follow the import wizard to complete the process.
note

Import functionality allows you to quickly set up apps from templates or migrate apps between environments.

Delete an App​

warning

Deleting an app permanently removes all associated data including functions, policies, roles, storage buckets, and database tables. This action cannot be undone.

  1. Navigate to the App in the Dashboard.
  2. Click the Settings tab.
  3. Find the Danger Zone section.
  4. Click Delete App.
  5. Type the app name to confirm.
  6. Click Delete App Permanently.

App Dashboard​

Once you open an app, you have access to the following features:

FeatureDescription
FunctionsCreate and manage serverless functions
EventsConfigure event subscriptions for functions
PoliciesDefine authorization rules and access control
RolesManage app-level user roles
StorageManage file storage buckets and objects
DatabaseCreate and manage data tables
AnalyticsBuild and run custom queries
SettingsConfigure app settings

Configuration​

App Fields​

FieldDescriptionRequired
NameDisplay name for the appYes
DescriptionPurpose of the appNo
URLPublic URL for the appNo
Editor URLAdmin interface URLNo

Limits​

ResourceLimit
Apps per siteVaries by plan
Functions per app100
Storage buckets per app20
Database tables per app50
info

Need higher limits? Contact support to discuss your requirements.

Troubleshooting​

App not appearing in list​

Problem: A newly created app doesn't appear in the apps list.

Solution:

  1. Refresh the page to reload the apps list.
  2. Check that you're viewing the correct site.
  3. Use the search to find the app by name.

Cannot delete app​

Problem: The delete button is disabled or deletion fails.

Solution:

  1. Ensure you have the correct permissions.
  2. Check that no other processes are using the app.
  3. Try again after a few moments.

Import fails​

Problem: App import fails with an error.

Solution:

  1. Verify the import file format is correct.
  2. Check that the file isn't corrupted.
  3. Ensure you have sufficient permissions.
  4. Review the error message for specific issues.

Last Updated: January 2025